feat(eve): deploy declarative agent workspaces by OwenKephart · Pull Request #1926 · vercel/eve

OwenKephart · 2026-08-11T01:48:39Z

Description

Makes a declared, hostless collection deployable as peer Vercel services. From the collection root, eve build infers one service for each strict agents/<name>/agent/ member and exposes it at /eve/agents/<name>/eve/v1/*.

my-agents/
├── package.json                 # { "eve": { "agents": ["agents/*"] } }
├── .env.local                   # shared by every collection member
└── agents/
    ├── support/agent/
    └── research/agent/

For example, the following root package opts into the inferred deployment path:

{
  "name": "my-agents",
  "private": true,
  "type": "module",
  "eve": { "agents": ["agents/*"] },
  "scripts": {
    "build": "eve build"
  },
  "dependencies": {
    "eve": "^0.x"
  }
}

The collection root owns build, link, and deploy; member commands run one selected agent and inherit the shared root environment. Child directories do not define package.json files or build scripts.

The inferred graph is deliberately the no-configuration path. If vercel.json declares services, that authored graph remains authoritative; use vercel build for heterogeneous projects with a frontend, private APIs, bindings, or other services. A framework app using withEve is also an explicit alternative: its framework build owns deployment assembly and is not required to use the strict collection layout.

How did you test your changes?

pnpm --filter eve typecheck
pnpm lint
pnpm docs:check
pnpm guard:invariants
Collection build, link, and deploy integration tests
Hostless collection scenario coverage in CI

PR Checklist

I linked an issue with prior discussion confirming this change is wanted
I ran the relevant checks from CONTRIBUTING.md
I added tests and documentation where relevant
I added a changeset
DCO sign-off passes for every commit (git commit --signoff)

vercel · 2026-08-11T01:48:45Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
eve-docs	Error		Aug 14, 2026 9:27pm
eve-docs-4759	Error		Aug 14, 2026 9:27pm

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
eve-pkg	Skipped		Aug 14, 2026 9:27pm

github-actions · 2026-08-11T01:52:37Z

Bundle + Package Summary: `apps/fixtures/weather-agent`

Key takeaways

No notable deltas vs feat/agent-collection-topology (dbc818d).

Delta vs `feat/agent-collection-topology (dbc818d)`

Area	Metric	Baseline	Current	Delta
Package	Packed tarball	8.21 MB	8.21 MB	-286 B ✅
Package	Unpacked publish size	30.81 MB	30.81 MB	+5.4 kB ⚠️
Package	Installed footprint	74.33 MB	74.34 MB	+5.4 kB ⚠️
Package	Published files	3325	3329	+4
Package	Installed files	7033	7037	+4
Package	Installed package instances	35	35	0
Package	Distinct installed package names	34	34	0
Package	Installed dependency edges	52	52	0
Package	Installed optional peer edges	47	47	0
Runtime	Unique function payloads	2	2	0
Runtime	Total function bytes	17.89 MB	17.89 MB	-40 B ✅
Runtime	Public routes	16	16	0

Changed function payloads vs feat/agent-collection-topology (dbc818d) (2)

Function	Status	Baseline	Current	Delta	Route changes
`functions/__server.func`	changed	8.95 MB	8.95 MB	-20 B ✅	none
`functions/.well-known/workflow/v1/flow.func`	changed	8.95 MB	8.95 MB	-20 B ✅	none

`eve init` install

Metric	Baseline	Current	Delta
Installed footprint	112.74 MB	112.75 MB	+5.4 kB ⚠️
Installed packages	121	121	0
dependencies	4	4	0
devDependencies	2	2	0
Dependency package bytes	45.30 MB	45.31 MB	+5.4 kB ⚠️
devDependency package bytes	5.04 MB	5.04 MB	0 B ➖

Build Metadata

Preset: vercel
Nitro: nitro@3.0.260610-beta
Output directory: apps/fixtures/weather-agent/.vercel/output
Build metadata timestamp: 2026-08-14T18:00:41.655Z
Route aliases: 16 public, 1 internal (17 total aliases)
Vercel routes in config: 19
Severity legend: 🔴 dominant/large, 🟠 notable, 🟡 watch, ⚪ small

Package Drill-Down

Package Details

Package: eve@0.38.1
Package directory: packages/eve
Tarball: 8.21 MB (eve-0.38.1.tgz)
Unpacked payload: 30.81 MB across 3329 published files
Installed footprint: 74.34 MB across 7037 installed files
Installed root package: 29.46 MB
Installed dependencies: 44.88 MB
Installed package instances: 35
Distinct installed package names: 34
Installed dependency edges: 52
Installed optional peer edges: 47
Runtime dependencies: 2
Peer dependencies: 5 (4 optional)

Installed footprint is measured from an isolated temporary npm install of the packed tarball.
Graph metrics read only package.json files in package directories directly beneath a node_modules boundary, including nested boundaries. Each directory is one package instance; distinct names come from those manifests. Dependency edges count each unique name in dependencies or optionalDependencies per instance; optional peer edges count peerDependencies marked optional.

Heavy installed dependencies

eve: 29.46 MB (39.6%)
@rolldown/binding-linux-x64-gnu: 19.41 MB (26.1%)
ai: 6.68 MB (9.0%)
zod: 5.07 MB (6.8%)
undici: 3.50 MB (4.7%)

Publish payload breakdown

Published file size
🔴 dist/src/compiled/shadcn-registry/index.js       [################........] 10.20 MB 33.1%
🟠 dist/src/compiled/@photon-ai/chat-adapter-ime... [####....................] 2.44 MB 7.9%
🟠 dist/src/compiled/experimental-ai-sdk-code-mo... [##......................] 1.51 MB 4.9%
🟡 dist/src/compiled/_chunks/node/undici-CUIybhQ... [#.......................] 508.8 kB 1.7%
🟡 dist/src/compiled/_chunks/workflow/undici-BBG... [#.......................] 508.8 kB 1.7%
🔴 Other published files                            [########################] 15.65 MB 50.8%

Installed footprint breakdown

Installed package size
🔴 eve                             [########################] 29.46 MB 39.6%
🔴 @rolldown/binding-linux-x64-gnu [################........] 19.41 MB 26.1%
🔴 ai                              [#####...................] 6.68 MB 9.0%
🔴 zod                             [####....................] 5.07 MB 6.8%
🟠 undici                          [###.....................] 3.50 MB 4.7%
🟠 nitro                           [##......................] 2.41 MB 3.2%
🔴 Other installed packages        [######..................] 7.81 MB 10.5%

Runtime dependencies (2)

Package	Range	Notes
`nitro`	`3.0.260610-beta`
`undici`	`8.9.0`

Peer dependencies (5)

Package	Range	Notes
`@opentelemetry/api`	`^1.0.0`	optional peer
`ai`	`catalog:`
`braintrust`	`^3.0.0`	optional peer
`just-bash`	`^3.0.0`	optional peer
`microsandbox`	`^0.5.0`	optional peer

eve init install drill-down

`eve init` install details

Command: eve init my-agent
Package manager: npm
Installed footprint: 112.75 MB across 8913 installed files
Installed packages: 121 total (115 transitive-only)
dependencies: 4 direct packages totaling 45.31 MB
devDependencies: 2 direct packages totaling 5.04 MB
Other transitive package files: 62.40 MB

Installed footprint is measured from an isolated temporary eve init my-agent using the current packed eve tarball.

Heavy installed dependencies

eve: 29.46 MB (26.1%)
@typescript/typescript-linux-x64: 27.95 MB (24.8%)
@rolldown/binding-linux-x64-gnu: 19.41 MB (17.2%)
zod: 9.02 MB (8.0%)
ai: 6.68 MB (5.9%)

Installed footprint breakdown

Installed package size
🔴 eve                              [########################] 29.46 MB 26.1%
🔴 @typescript/typescript-linux-x64 [#######################.] 27.95 MB 24.8%
🔴 @rolldown/binding-linux-x64-gnu  [################........] 19.41 MB 17.2%
🔴 zod                              [#######.................] 9.02 MB 8.0%
🔴 ai                               [#####...................] 6.68 MB 5.9%
🟠 undici                           [###.....................] 3.50 MB 3.1%
🔴 Other installed packages         [##############..........] 16.72 MB 14.8%

dependencies (4)

Package	Range	Installed size	Share
`@vercel/connect`	`0.4.3`	141.0 kB	0.1%
`ai`	`^7.0.58`	6.68 MB	5.9%
`eve`	`file:eve-0.38.1.tgz`	29.46 MB	26.1%
`zod`	`4.4.3`	9.02 MB	8.0%

devDependencies (2)

Package	Range	Installed size	Share
`@types/node`	`24.x`	2.54 MB	2.3%
`typescript`	`7.0.2`	2.50 MB	2.2%

Function Drill-Down

Payload Size Graph

Unique function payload size and share of total
🔴 functions/.well-known/workflow/v1/flow.func     [########################] 8.95 MB 50.0%
🔴 functions/__server.func                         [########################] 8.95 MB 50.0%

Top Function Payloads

🟠 functions/.well-known/workflow/v1/flow.func • 1 public route • 8.95 MB

Metric	Value
Public routes	`/.well-known/workflow/v1/flow`
Runtime	`nodejs24.x`
Handler	`index.mjs`
Payload	8.95 MB
Function files	8.95 MB across 50 files
Traced dependencies	0 B
Signal	🟠 Bundled file `index.mjs` is 1.99 MB (22.2%)

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                     [#################.......] 1.99 MB 22.2%
🟠 _chunks/runtime-artifacts.mjs [###############.........] 1.74 MB 19.4%
🟡 _libs/undici.mjs              [########................] 980.5 kB 11.0%
🟡 _chunks/sandbox.mjs           [#######.................] 781.9 kB 8.7%
🟡 _chunks/frames-BBs-9k1d.mjs   [######..................] 671.4 kB 7.5%
🟠 Other bundled files           [########################] 2.79 MB 31.1%

🧾 Vercel Config

{
  "handler": "index.mjs",
  "launcherType": "Nodejs",
  "shouldAddHelpers": false,
  "supportsResponseStreaming": true,
  "runtime": "nodejs24.x",
  "maxDuration": "max",
  "experimentalTriggers": [
    {
      "type": "queue/v2beta",
      "topic": "__eve776561746865722d6167656e74_wkf_workflow_*",
      "consumer": "default",
      "retryAfterSeconds": 5,
      "initialDelaySeconds": 0
    }
  ],
  "environment": {
    "WORKFLOW_PRECONDITION_GUARD": "1"
  }
}

🟠 functions/__server.func • 15 public routes, 1 internal alias • 8.95 MB

Metric	Value
Public routes	`/` `/eve/v1/callback/[token]` `/eve/v1/connections/[name]/callback/[attemptId]/[token]` `/eve/v1/connections/[name]/callback/[token]` `/eve/v1/health` `/eve/v1/info` `/eve/v1/session` `/eve/v1/session/[parentSessionId]/subagents/[callId]/[childSessionId]/stream` `/eve/v1/session/[sessionId]` `/eve/v1/session/[sessionId]/cancel` `/eve/v1/session/[sessionId]/clear` `/eve/v1/session/[sessionId]/compact` `/eve/v1/session/[sessionId]/reset` `/eve/v1/session/[sessionId]/stream` `/eve/v1/task-input/[token]`
Internal aliases	`/__server`
Runtime	`nodejs24.x`
Handler	`index.mjs`
Payload	8.95 MB
Function files	8.95 MB across 50 files
Traced dependencies	0 B
Signal	🟠 Bundled file `index.mjs` is 1.99 MB (22.2%)

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                     [#################.......] 1.99 MB 22.2%
🟠 _chunks/runtime-artifacts.mjs [###############.........] 1.74 MB 19.5%
🟡 _libs/undici.mjs              [########................] 980.5 kB 11.0%
🟡 _chunks/sandbox.mjs           [#######.................] 781.9 kB 8.7%
🟡 _chunks/frames-BBs-9k1d.mjs   [######..................] 671.4 kB 7.5%
🟠 Other bundled files           [########################] 2.79 MB 31.1%

🧾 Vercel Config

{
  "handler": "index.mjs",
  "launcherType": "Nodejs",
  "shouldAddHelpers": false,
  "supportsResponseStreaming": true,
  "runtime": "nodejs24.x"
}

Build Timing: `e2e/fixtures/agent-tools-sandbox`

This is an informational timing measurement inside eve build, from preflight through publication. Output-size measurement and profile writing are excluded.

Build mode: deployable Vercel build with sandbox template prewarm included.

Build pipeline: 2.39 s -> 2.70 s (+306.5 ms) vs feat/agent-collection-topology (dbc818d).
Timing is informational: shared GitHub runners are too variable for a hard timing budget.

Detailed phase timings vs `feat/agent-collection-topology (dbc818d)`

Phase	Baseline	Current	Delta
`extension.check`	0.8 ms	0.7 ms	-0.1 ms
`project.resolve`	0.3 ms	0.4 ms	+0.1 ms
`workspace.create`	0.8 ms	0.8 ms	0.0 ms
`host.prepare`	332.1 ms	286.9 ms	-45.2 ms
`vercel.service-prefix.resolve`	2.5 ms	2.6 ms	+0.1 ms
`nitro.create`	269.4 ms	255.6 ms	-13.8 ms
`sandbox.prewarm`	272.8 ms	652.0 ms	+379.2 ms
`nitro.cache.prepare`	0.3 ms	0.3 ms	0.0 ms
`nitro.prepare`	1.0 ms	0.8 ms	-0.2 ms
`nitro.public-assets`	0.8 ms	0.8 ms	0.0 ms
`nitro.prerender`	0.5 ms	0.5 ms	0.0 ms
`nitro.bundle`	1.48 s	1.46 s	-14.2 ms
`nitro.cache.write`	0.4 ms	0.4 ms	0.0 ms
`vercel.workflow-function.materialize`	26.9 ms	27.7 ms	+0.8 ms
`agent-summary.emit`	0.6 ms	0.6 ms	0.0 ms
`nitro.close`	0.1 ms	0.2 ms	+0.1 ms
`output.publish`	3.7 ms	3.5 ms	-0.2 ms
`workspace.remove`	2.4 ms	2.3 ms	-0.1 ms

Signed-off-by: owenkephart <owen.kephart@vercel.com>

vercel · 2026-08-14T21:30:11Z

+const VERCEL_BUILD_OUTPUT_VERSION = 3;
+
+async function hasBuildScript(member: AgentWorkspaceMember): Promise<boolean> {
+  if (member.packageJsonPath === undefined) return false;


build-agent-workspace.ts accesses member.packageJsonPath, a property that does not exist on AgentWorkspaceMember, causing a TS2339 compile error that breaks the build.

ruiconti · 2026-08-14T22:18:17Z

+    packageJson.scripts = { build: "eve build" };
+    await writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`);
+
+    await runPnpmCommand({ args: ["exec", "vercel", "build", "--yes"], cwd: app.appRoot });


This scenario stops one boundary before the feature users actually invoke. It proves that two function bundles exist, but not that either agent works through its public route after deployment.

Concrete failure that would still leave this test green:

Deploy support and research.

Call /eve/agents/support/eve/v1/session.

The platform rewrite targets the wrong service, the service sees the prefixed path, or a generated callback drops /eve/agents/support.

The initial request or later continuation returns 404.

This test still passes because config.json and both __server.func directories exist.

Can we add a deployed/e2e fixture that calls health and session routes on both prefixes, then exercises one callback or post-hook continuation and verifies it returns to the same agent? That is the runtime contract this PR is exposing.

OwenKephart mentioned this pull request Aug 11, 2026

feat(eve): deploy declarative agent collections #1923

Closed

5 tasks

vercel Bot deployed to Preview – eve-docs-4759 August 11, 2026 01:50 View deployment

vercel Bot deployed to Preview – eve-docs August 11, 2026 01:50 View deployment

OwenKephart marked this pull request as draft August 11, 2026 01:50

OwenKephart force-pushed the feat/hostless-multi-agent-deployment branch from 7e5d370 to 2826cb5 Compare August 11, 2026 17:43

vercel Bot deployed to Preview – eve-docs-4759 August 11, 2026 17:45 View deployment

vercel Bot deployed to Preview – eve-docs August 11, 2026 17:45 View deployment

OwenKephart force-pushed the feat/hostless-multi-agent-deployment branch from 2826cb5 to 23441e4 Compare August 11, 2026 18:11

vercel Bot deployed to Preview – eve-docs-4759 August 11, 2026 18:12 View deployment

vercel Bot deployed to Preview – eve-docs August 11, 2026 18:13 View deployment

OwenKephart marked this pull request as ready for review August 11, 2026 21:46

OwenKephart force-pushed the feat/hostless-multi-agent-deployment branch 2 times, most recently from b3173cf to 6026b3e Compare August 11, 2026 23:21

vercel Bot deployed to Preview – eve-docs-4759 August 11, 2026 23:23 View deployment

vercel Bot deployed to Preview – eve-docs August 11, 2026 23:23 View deployment

OwenKephart force-pushed the feat/hostless-multi-agent-deployment branch from 6026b3e to 92ae6a7 Compare August 11, 2026 23:25

OwenKephart force-pushed the feat/hostless-multi-agent-deployment branch from 92ae6a7 to 1a77760 Compare August 11, 2026 23:26

vercel Bot temporarily deployed to Preview – eve-docs-4759 August 11, 2026 23:26 Inactive

vercel Bot deployed to Preview – eve-docs August 11, 2026 23:27 View deployment

OwenKephart force-pushed the feat/hostless-multi-agent-deployment branch from 1a77760 to 4e0fe1c Compare August 12, 2026 17:19

vercel Bot deployed to Preview – eve-docs-4759 August 12, 2026 17:21 View deployment

vercel Bot deployed to Preview – eve-docs August 12, 2026 17:21 View deployment

OwenKephart force-pushed the feat/hostless-multi-agent-deployment branch from 4e0fe1c to 8052e2f Compare August 12, 2026 21:37

vercel Bot deployed to Preview – eve-pkg August 13, 2026 17:07 View deployment

vercel Bot deployed to Preview – eve-docs-4759 August 13, 2026 17:07 View deployment

vercel Bot deployed to Preview – eve-docs August 13, 2026 17:08 View deployment

OwenKephart force-pushed the feat/hostless-multi-agent-deployment branch from 914409b to a33a357 Compare August 14, 2026 14:09

vercel Bot had a problem deploying to Preview – eve-docs August 14, 2026 14:10 Failure

vercel Bot had a problem deploying to Preview – eve-docs-4759 August 14, 2026 14:10 Failure

vercel Bot deployed to Preview – eve-pkg August 14, 2026 14:10 View deployment

vercel Bot reviewed Aug 14, 2026

View reviewed changes

Comment thread packages/eve/src/cli/commands/build.ts Outdated

OwenKephart force-pushed the feat/hostless-multi-agent-deployment branch from a33a357 to 95d8b53 Compare August 14, 2026 15:19

vercel Bot deployed to Preview – eve-pkg August 14, 2026 15:19 View deployment

vercel Bot had a problem deploying to Preview – eve-docs-4759 August 14, 2026 15:20 Failure

vercel Bot had a problem deploying to Preview – eve-docs August 14, 2026 15:20 Failure

OwenKephart added 5 commits August 14, 2026 17:55

feat(eve): deploy declarative agent collections

21671b7

Signed-off-by: owenkephart <owen.kephart@vercel.com>

refactor(eve): standardize collection builds

b8dbbdb

Signed-off-by: owenkephart <owen.kephart@vercel.com>

refactor(eve): rename agent collection deployment to workspace

97125ef

Signed-off-by: owenkephart <owen.kephart@vercel.com>

fix(eve): materialize agent workspace service roots

58fd40a

Signed-off-by: owenkephart <owen.kephart@vercel.com>

fix(eve): resolve workspace builds from CLI roots

0f1cf83

Signed-off-by: owenkephart <owen.kephart@vercel.com>

OwenKephart force-pushed the feat/hostless-multi-agent-deployment branch from 95d8b53 to 0f1cf83 Compare August 14, 2026 17:57

vercel Bot deployed to Preview – eve-pkg August 14, 2026 17:58 View deployment

vercel Bot deployed to Preview – eve-docs-4759 August 14, 2026 17:58 View deployment

vercel Bot deployed to Preview – eve-docs August 14, 2026 17:59 View deployment

fix(eve): preserve agent workspace build output

86b4108

Signed-off-by: owenkephart <owen.kephart@vercel.com>

vercel Bot temporarily deployed to Preview – eve-pkg August 14, 2026 21:27 Inactive

vercel Bot had a problem deploying to Preview – eve-docs-4759 August 14, 2026 21:27 Failure

vercel Bot had a problem deploying to Preview – eve-docs August 14, 2026 21:27 Failure

vercel Bot reviewed Aug 14, 2026

View reviewed changes

ruiconti reviewed Aug 14, 2026

View reviewed changes

Navigation Menu

Uh oh!

feat(eve): deploy declarative agent workspaces - #1926

feat(eve): deploy declarative agent workspaces#1926
OwenKephart wants to merge 6 commits into
feat/agent-collection-topologyfrom
feat/hostless-multi-agent-deployment

OwenKephart commented Aug 11, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Aug 11, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Aug 11, 2026 •

edited

Loading

Package Details

`eve init` install details

Payload Size Graph

Top Function Payloads

Uh oh!

Uh oh!

vercel Bot Aug 14, 2026

Uh oh!

ruiconti Aug 14, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

OwenKephart commented Aug 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

How did you test your changes?

PR Checklist

Uh oh!

vercel Bot commented Aug 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Aug 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Bundle + Package Summary: apps/fixtures/weather-agent

Delta vs feat/agent-collection-topology (dbc818d)

eve init install

Package Details

eve init install details

Payload Size Graph

Top Function Payloads

Build Timing: e2e/fixtures/agent-tools-sandbox

Uh oh!

Uh oh!

vercel Bot Aug 14, 2026

Choose a reason for hiding this comment

Uh oh!

ruiconti Aug 14, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

OwenKephart commented Aug 11, 2026 •

edited

Loading

vercel Bot commented Aug 11, 2026 •

edited

Loading

github-actions Bot commented Aug 11, 2026 •

edited

Loading

Bundle + Package Summary: `apps/fixtures/weather-agent`

Delta vs `feat/agent-collection-topology (dbc818d)`

`eve init` install

`eve init` install details

Build Timing: `e2e/fixtures/agent-tools-sandbox`